home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / public / ghostview / inst / ghostview.manPage < prev    next >
Text File  |  1994-08-01  |  52KB  |  1,220 lines
  1.  
  2.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  3.  
  4.      NAME
  5.           ghostview - View PostScript documents using ghostscript
  6.  
  7.      SYNOPSIS
  8.           ghostview [filename]
  9.           or
  10.           ghostview [-staticgray] [-grayscale] [-staticcolor]
  11.           [-pseudocolor] [-truecolor] [-directcolor] [-[no]install]
  12.           [-[no]private] [-[no]center] [-[no]title] [-[no]date]
  13.           [-[no]locator] [-[no]labels] [-resolution dpi] [-dpi dpi]
  14.           [-xdpi dpi] [-ydpi dpi] [-[no]quiet] [-preload file]
  15.           [-magstep n] [-portrait] [-landscape] [-upsidedown]
  16.           [-seascape] [-letter] [-tabloid] [-ledger] [-legal]
  17.           [-statement] [-executive] [-a3] [-a4] [-a5] [-b4] [-b5]
  18.           [-folio] [-quarto] [-10x14] [-force] [-forceorientation]
  19.           [-forcemedia] [-[no]swap] [-[no]openwindows] [-[no]ncdwm]
  20.           [-page label] [-toolkitoption ...]  [filename]
  21.  
  22.      DESCRIPTION
  23.           The ghostview program provides an X11 user interface for the
  24.           ghostscript interpreter.  Ghostview and ghostscript function
  25.           as two cooperating programs.  Ghostview creates the viewing
  26.           window and ghostscript draws in it.
  27.  
  28.           Don't be alarmed by the number of options.  Generally, one
  29.           invokes ghostview with just one parameter, the name of the
  30.           file to be previewed.  If the filename is ``-'', ghostview
  31.           will read from ``stdin''.  The options provide a way to set
  32.           X resources from the command line for a single invocation of
  33.           ghostview.  For that reason, discussion of the options is
  34.           delayed until after the X resources are discussed.
  35.  
  36.      MAIN WINDOW
  37.           The main viewport is on the right side of the main window.
  38.           If the page is larger than the viewport, there will be
  39.           scroll bars along the bottom and right edges of the
  40.           viewport.  To the left of the viewport is the table of
  41.           contents.  If the PostScript file has document structuring
  42.           convention (DSC) comments, the table of context will display
  43.           the page labels (i.e. usually page numbers).  To the left of
  44.           the table of contents is the menu box.  Each push button
  45.           brings up a popup menu.  Over the menu box and table of
  46.           contents there are three optional labels that contain the
  47.           title, date, and locator.  The title label contains the
  48.           document title found in the DSC comments.  If no title can
  49.           be found, the filename is used in its place.  The date label
  50.           contains the document date found in the DSC comments.  If no
  51.           date can be found, the last modified date of the file is
  52.           used in its place.  Since the title and date labels may be
  53.           clipped by the main viewport, the date and title labels are
  54.           push buttons that bring up a popup window with the title or
  55.           date.  These popup windows also show the ``document'' icon
  56.  
  57.      Page 1                                          (printed 4/15/93)
  58.  
  59.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  60.  
  61.           when the displayed string comes from the DSC comments.  The
  62.           locator shows the location of the cursor in the viewport.
  63.           The location is expressed in the default user coordinate
  64.           system.  The locator is useful for measuring bounding boxes.
  65.  
  66.           Within the main viewport the mouse cursor is a ``target''
  67.           when ghostscript is doing work.  The cursor is a ``cross
  68.           hair'' when ghostscript is idle.  When moving to another
  69.           page in a document, it is generally best to wait for
  70.           ghostscript to become idle.  Otherwise, the current
  71.           ghostscript process must be killed and the overhead of
  72.           reading the prologue is incurred again.
  73.  
  74.           Ghostview will check to see if the file has been modified
  75.           just before it displays a page or when the application is
  76.           deiconified.  If the file has changed, it will reopen the
  77.           file.
  78.  
  79.           Clicking anywhere within the viewport will popup a zoom
  80.           window.  The window is centered about the location that was
  81.           clicked.  Clicking with the first mouse button pops up a low
  82.           resolution zoom window.  Clicking with the second mouse
  83.           button pops up a medium resolution zoom window.  Clicking
  84.           with the third mouse button pops up a high resolution zoom
  85.           window.  The cursor in the zoom window will display a
  86.           ``target'' or ``cross hair'' depending on the state of
  87.           ghostscript.  The locator reports the position of the cursor
  88.           in the zoom windows as well as the main viewport.
  89.  
  90.           In the table of contents, the first and third mouse button
  91.           functions exactly as they do in a Text widget.  That is the
  92.           first mouse button selects text and the third mouse button
  93.           extends selections.  However, clicking on a page label with
  94.           the second mouse button will cause that page to be shown.
  95.           The page being displayed is marked with a '<' in the right
  96.           margin of the table of contents.
  97.  
  98.      POPUP WINDOWS
  99.           The are several additional windows that may appear.  The
  100.           copyright window will appear whenever copyright information
  101.           is requested.  The information window appears whenever the
  102.           ghostscript process writes to ``stdout'' or ``stderr''.
  103.           Whenever there is an error in the PostScript program, the
  104.           stack trace will appear in this window.  When ghostscript is
  105.           invoked without the quiet option, informational message
  106.           regarding the state of ghostscript will appear in the
  107.           information window.  The copyright and information windows
  108.           can be dismissed by pushing the ``Dismiss'' button.
  109.  
  110.           The Select File dialog widget will appear when you wish to
  111.           open or save a file.  The Select File dialog widget allows
  112.           an X11 user to select a file by typing the path or by
  113.  
  114.      Page 2                                          (printed 4/15/93)
  115.  
  116.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  117.  
  118.           browsing in directory listings and selecting entries with
  119.           the mouse.
  120.  
  121.           The space bar can be pressed to complete filenames, and
  122.           tilde is used for home directories.  All the usual key
  123.           bindings can be used in the text widget, except for Return
  124.           and Control-M, which are equivalent to pressing the OK
  125.           button.  The path can be scrolled using the large horizontal
  126.           scroll bar, or by moving the insertion cursor in the text
  127.           widget.  The directory entries can be scrolled using the
  128.           vertical scroll bars, or by holding a mouse button down and
  129.           moving out of the listing.  The scrolling speed varies with
  130.           the distance from the listing.
  131.  
  132.           The directory entries are terminated with special characters
  133.           that show the type of entry, similar to the -F option of
  134.           ls(1).
  135.  
  136.           The Select File dialog widget is in total control until is
  137.           pops down.  No other controls in ghostview will be active
  138.           during this time.
  139.  
  140.      MENUS
  141.           There are five buttons in the menu box.  They are the File,
  142.           Page, Magstep, Orientation, and Media buttons.  There are
  143.           keyboard accelerators for most of the popup menus.  Be sure
  144.           to read the keyboard accelerator section.
  145.  
  146.           File      This popup menu controls file access:
  147.  
  148.                     Open...   Pops up the Select File window in
  149.                               preparation to open a file.  The Select
  150.                               File widget is in total control until it
  151.                               pops down.  Opens the file for viewing.
  152.  
  153.                     Reopen    Reopens the current file.
  154.  
  155.                     Print...  Pops up a dialog widget to ask for the
  156.                               printer name.  Sends the whole document
  157.                               to the printer.
  158.  
  159.                     Print marked pages...
  160.                               Pops up a dialog widget to ask for the
  161.                               printer name.  Sends the marked pages to
  162.                               the printer.  If no pages have been
  163.                               marked, the mark procedure is called
  164.                               before printing and then the unmark
  165.                               procedure is called after printing.
  166.  
  167.                     Save marked pages...
  168.                               Pops up the Select File window in
  169.                               preparation to save a file.  The Select
  170.  
  171.      Page 3                                          (printed 4/15/93)
  172.  
  173.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  174.  
  175.                               File widget is in total control until it
  176.                               pops down.  Saves the marked pages in
  177.                               the selected file.  If no pages have
  178.                               been marked, the mark procedure is
  179.                               called before saving and then the unmark
  180.                               procedure is called after saving.
  181.  
  182.                     Copyright...
  183.                               Pops up the copyright window.
  184.  
  185.                     Quit      Causes ghostview to exit.
  186.  
  187.           Page      This popup menu controls page access:
  188.  
  189.                     Next      Display the next page.
  190.  
  191.                     Redisplay Display the current page.
  192.  
  193.                     Previous  Display the previous page.
  194.  
  195.                     Center    Center the page in the viewport.
  196.  
  197.                     Mark      Mark the pages that have been selected
  198.                               in the table of contents.  If no pages
  199.                               have been selected, mark the current
  200.                               page.
  201.  
  202.                     Unmark    Unmark the pages that have been selected
  203.                               in the table of contents.  If no pages
  204.                               have been selected, unmark the current
  205.                               page.
  206.  
  207.           Magstep   The Magstep menu controls the magnification at
  208.                     which the document is viewed.  The default magstep
  209.                     of 0 implies no magnification (i.e. the size on
  210.                     the screen should match the size on paper).
  211.                     Ghostview borrows the notion of magstep from TeX.
  212.                     The magnification is defined to be 1.2**magstep.
  213.                     At magstep 1, the document is magnified by 1.2.
  214.                     At magstep -1, the document is reduced by 1.2.
  215.                     The Magstep menu lists values from -5 to 5.
  216.  
  217.           Orientation
  218.                     The Orientation menu controls the display
  219.                     orientation.  A ``dot'' appears in front of the
  220.                     current orientation.  The first mouse button sets
  221.                     the default orientation.  The DSC comments may
  222.                     specify an orientation of Portrait or Landscape
  223.                     that overrides the default.  In this case, a
  224.                     "document" appears in front of the current
  225.                     orientation.  The second mouse button can be used
  226.                     to ``force'' the orientation on a document to
  227.  
  228.      Page 4                                          (printed 4/15/93)
  229.  
  230.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  231.  
  232.                     override the DSC comments.  If an orientation is
  233.                     being forced, then a ``tie fighter'' will appear
  234.                     in front of the current orientation.
  235.  
  236.                     Portrait  Set the orientation to Portrait. This
  237.                               implies no rotation.  A portrait
  238.                               orientation indicates that the longest
  239.                               edge of the paper is parallel to the
  240.                               vertical (y) axis.
  241.  
  242.                     Landscape Set the orientation to Landscape.  This
  243.                               implies a clockwise rotation of the
  244.                               paper by 90 degrees.  A landscape
  245.                               orientation indicates that the longest
  246.                               edge of the paper is parallel to the
  247.                               horizontal (x) axis.
  248.  
  249.                     Upside-down
  250.                               Set the orientation to Upside-Down.
  251.  
  252.                     Seascape  Set the orientation to Seascape.  This
  253.                               implies a counterclockwise rotation of
  254.                               the paper by 90 degrees.
  255.  
  256.                     Swap Landscape
  257.                               Swap the meaning of Landscape and
  258.                               Seascape.  Most of the Landscape
  259.                               documents that I have encountered
  260.                               require a 90 clockwise rotation of the
  261.                               paper to view.   However, there is no
  262.                               standard and some documents need to be
  263.                               rotated the other way.  The swap
  264.                               landscape button allows ghostview to
  265.                               automatically rotate the document the
  266.                               right way in response to the
  267.                               %%Orientation comment in the PostScript
  268.                               file.
  269.  
  270.           Media     The entries on the Media menu set the page media.
  271.                     Media defined in the document appear at the
  272.                     beginning of the menu separated by a line from the
  273.                     standard media.  A ``dot'' appears in front of the
  274.                     current media.  The first mouse button sets the
  275.                     default media.  The DSC comments may specify the
  276.                     page media that overrides the default.  In this
  277.                     case, a "document" appears in front of the current
  278.                     media.  The second mouse button can be used to
  279.                     ``force'' the media on a document to override the
  280.                     DSC comments.  Forcing the media on an EPSF figure
  281.                     will override the Bounding Box.  This makes is
  282.                     easy to view a figure with an incorrect
  283.                     %%BoundingBox comment.  If a media is being
  284.  
  285.      Page 5                                          (printed 4/15/93)
  286.  
  287.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  288.  
  289.                     forced, then a ``tie fighter'' will appear in
  290.                     front of the current media.
  291.  
  292.                     Here are the standard media names and their sizes.
  293.                     The size is given as the width and height in
  294.                     PostScript points.
  295.                     Letter          612 x  792    (8.5 x 11  in.)
  296.                     Tabloid         792 x 1224    (11  x 17  in.)
  297.                     Ledger         1224 x  792    (17  x 11  in.)
  298.                     Legal           612 x 1008    (8.5 x 14  in.)
  299.                     Statement       396 x  612    (5.5 x 8.5 in.)
  300.                     Executive       540 x  720    (7.5 x 10  in.)
  301.                     A3              842 x 1190
  302.                     A4              595 x  842
  303.                     A5              420 x  595
  304.                     B4              729 x 1032
  305.                     B5              516 x  729
  306.                     Folio           612 x  936    (8.5 x 13  in.)
  307.                     Quarto          610 x  780
  308.                     10x14           720 x 1008    (10  x 14  in.)
  309.  
  310.      KEYBOARD ACCELERATORS
  311.           Most of the popup menu commands have an equivalent action
  312.           that can be invoked from the keyboard.  The popup menu entry
  313.           must be sensitive (i.e. not grayed out) for the action to
  314.           have effect.  Here is the default keyboard binding:
  315.  
  316.           Q         Bound to GhostviewQuit() which is equivalent to
  317.                     pushing the Quit menu button on the Ghostview
  318.                     menu.
  319.  
  320.           O         Bound to GhostviewOpen() which is equivalent to
  321.                     pushing the Open... menu button on the File menu.
  322.  
  323.           R         Bound to GhostviewReopen() which is equivalent to
  324.                     pushing the Reopen menu button on the File menu.
  325.  
  326.           S         Bound to GhostviewSave() which is equivalent to
  327.                     pushing the Save marked pages... menu button on
  328.                     the File menu.
  329.  
  330.           P         Bound to GhostviewPrintMarked() which is
  331.                     equivalent to pushing the Print marked pages...
  332.                     menu button on the File menu.
  333.  
  334.           Shift-P   Bound to GhostviewPrintWhole() which is equivalent
  335.                     to pushing the Print... menu button on the File
  336.                     menu.
  337.  
  338.           BackSpace, Delete, Prior, B
  339.                     Bound to GhostviewPrevious() which is equivalent
  340.                     to pushing the Previous menu button on the Page
  341.  
  342.      Page 6                                          (printed 4/15/93)
  343.  
  344.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  345.  
  346.                     menu.
  347.  
  348.           space, Return, Next, F
  349.                     Bound to GhostviewNext() which is equivalent to
  350.                     pushing the Next menu button on the Page menu.
  351.  
  352.           period, Ctrl-L
  353.                     Bound to GhostviewShow() which is equivalent to
  354.                     pushing the Redisplay menu button on the Page
  355.                     menu.
  356.  
  357.           M         Bound to GhostviewMark() which is equivalent to
  358.                     pushing the Mark menu button on the Page menu.
  359.  
  360.           N         Bound to GhostviewUnMark() which is equivalent to
  361.                     pushing the Unmark menu button on the Page menu.
  362.  
  363.           0         Bound to GhostviewMagstep(0) which is equivalent
  364.                     to pushing the 0 menu button on the Magstep menu.
  365.  
  366.           1         Bound to GhostviewMagstep(1) which is equivalent
  367.                     to pushing the 1 menu button on the Magstep menu.
  368.  
  369.           2         Bound to GhostviewMagstep(2) which is equivalent
  370.                     to pushing the 2 menu button on the Magstep menu.
  371.  
  372.           3         Bound to GhostviewMagstep(3) which is equivalent
  373.                     to pushing the 3 menu button on the Magstep menu.
  374.  
  375.           4         Bound to GhostviewMagstep(4) which is equivalent
  376.                     to pushing the 4 menu button on the Magstep menu.
  377.  
  378.           5         Bound to GhostviewMagstep(5) which is equivalent
  379.                     to pushing the 5 menu button on the Magstep menu.
  380.  
  381.           +         Bound to GhostviewIncreaseMagstep() which
  382.                     increases the magstep by 1.
  383.  
  384.           -         Bound to GhostviewDecreaseMagstep() which
  385.                     decreases the magstep by 1.
  386.  
  387.           U         Bound to GhostviewUp() which scrolls the main
  388.                     viewport up.
  389.  
  390.           D         Bound to GhostviewDown() which scrolls the main
  391.                     viewport down.
  392.  
  393.           H         Bound to GhostviewLeft() which scrolls the main
  394.                     viewport left.
  395.  
  396.           J         Bound to GhostviewDown() which scrolls the main
  397.                     viewport down.
  398.  
  399.      Page 7                                          (printed 4/15/93)
  400.  
  401.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  402.  
  403.           K         Bound to GhostviewUp() which scrolls the main
  404.                     viewport up.
  405.  
  406.           L         Bound to GhostviewRight() which scrolls the main
  407.                     viewport right.
  408.  
  409.           Up (arrow)
  410.                     Bound to GhostviewDefault()
  411.                     GhostviewSetOrientation(portrait) which is
  412.                     equivalent to pushing Portrait with the first
  413.                     mouse button on the Orientation menu.
  414.  
  415.           Right (arrow)
  416.                     Bound to GhostviewDefault()
  417.                     GhostviewSetOrientation(landscape) which is
  418.                     equivalent to pushing Landscape with the first
  419.                     mouse button on the Orientation menu.
  420.  
  421.           Down (arrow)
  422.                     Bound to GhostviewDefault()
  423.                     GhostviewSetOrientation(upside-down) which is
  424.                     equivalent to pushing Upside-down with the first
  425.                     mouse button on the Orientation menu.
  426.  
  427.           Left (arrow)
  428.                     Bound to GhostviewDefault()
  429.                     GhostviewSetOrientation(seascape) which is
  430.                     equivalent to pushing Seascape with the first
  431.                     mouse button on the Orientation menu.
  432.  
  433.           Shift-Up (arrow)
  434.                     Bound to GhostviewForce()
  435.                     GhostviewSetOrientation(portrait) which is
  436.                     equivalent to pushing Portrait with the second
  437.                     mouse button on the Orientation menu.
  438.  
  439.           Shift-Right (arrow)
  440.                     Bound to GhostviewForce()
  441.                     GhostviewSetOrientation(landscape) which is
  442.                     equivalent to pushing Landscape with the second
  443.                     mouse button on the Orientation menu.
  444.  
  445.           Shift-Down (arrow)
  446.                     Bound to GhostviewForce()
  447.                     GhostviewSetOrientation(upside-down) which is
  448.                     equivalent to pushing Upside-down with the second
  449.                     mouse button on the Orientation menu.
  450.  
  451.           Shift-Left (arrow)
  452.                     Bound to GhostviewForce()
  453.                     GhostviewSetOrientation(seascape) which is
  454.                     equivalent to pushing Seascape with the second
  455.  
  456.      Page 8                                          (printed 4/15/93)
  457.  
  458.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  459.  
  460.                     mouse button on the Orientation menu.
  461.  
  462.      ACTIONS
  463.           Most of the popup menu commands have an equivalent action
  464.           that can be used in a translation.  The popup menu entry
  465.           must be sensitive (i.e. not grayed out) for the action to
  466.           have effect.  Here is the list of actions:
  467.  
  468.           GhostviewCopyright()
  469.                     Equivalent to pushing the Copyright... menu button
  470.                     on the Ghostview menu.
  471.  
  472.           GhostviewQuit()
  473.                     Equivalent to pushing the Quit menu button on the
  474.                     Ghostview menu.
  475.  
  476.           GhostviewOpen()
  477.                     Equivalent to pushing the Open... menu button on
  478.                     the File menu.
  479.  
  480.           GhostviewReopen()
  481.                     Equivalent to pushing the Reopen menu button on
  482.                     the File menu.
  483.  
  484.           GhostviewSave()
  485.                     Equivalent to pushing the Save marked pages...
  486.                     menu button on the File menu.
  487.  
  488.           GhostviewPrintWhole()
  489.                     Equivalent to pushing the Print... menu button on
  490.                     the File menu.
  491.  
  492.           GhostviewPrintMarked()
  493.                     Equivalent to pushing the Print marked pages...
  494.                     menu button on the File menu.
  495.  
  496.           GhostviewPrevious()
  497.                     Equivalent to pushing the Previous menu button on
  498.                     the Page menu.
  499.  
  500.           GhostviewShow()
  501.                     Equivalent to pushing the Redisplay menu button on
  502.                     the Page menu.
  503.  
  504.           GhostviewNext()
  505.                     Equivalent to pushing the Next menu button on the
  506.                     Page menu.
  507.  
  508.           GhostviewCenter()
  509.                     Equivalent to pushing the Center menu button on
  510.                     the Page menu.
  511.  
  512.      Page 9                                          (printed 4/15/93)
  513.  
  514.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  515.  
  516.           GhostviewMark()
  517.                     Equivalent to pushing the Mark menu button on the
  518.                     Page menu.
  519.  
  520.           GhostviewUnmark()
  521.                     Equivalent to pushing the Unmark menu button on
  522.                     the Page menu.
  523.  
  524.           GhostviewSetMagstep(magstep)
  525.                     Sets the magstep.  The parameter must be an
  526.                     integer.
  527.  
  528.           GhostviewIncreaseMagstep()
  529.                     Increases magstep by one.
  530.  
  531.           GhostviewDecreaseMagstep()
  532.                     Decreases magstep by one.
  533.  
  534.           GhostviewSetOrientation(orientation)
  535.                     Set the orientation to the passed parameter.  The
  536.                     parameter must be portrait, landscape,
  537.                     upside-down, or seascape.
  538.  
  539.           GhostviewSwapLandscape()
  540.                     Equivalent to pushing the Swap Landscape menu
  541.                     button on the Orientation menu.
  542.  
  543.           GhostviewSetPageMedia(media-name)
  544.                     Sets the media.  The parameter should be either a
  545.                     media defined in the document or a standard media.
  546.  
  547.           GhostviewDefault()
  548.                     The orientation or media being set is not forced
  549.                     on the document.  This action is called before the
  550.                     action that sets the orientation or media.
  551.  
  552.           GhostviewForce()
  553.                     The orientation or media being set is forced on
  554.                     the document.  This action is called before the
  555.                     action that sets the orientation or media.
  556.  
  557.           GhostviewDeleteWindow()
  558.                     Destroy the current window.  This provides a way
  559.                     to implement the Delete Window protocol for window
  560.                     managers.
  561.  
  562.           GhostviewDismiss()
  563.                     Pop down the current window.  This provides a way
  564.                     to implement the Delete Window protocol for window
  565.                     managers.
  566.  
  567.           GhostviewScrollUp()
  568.  
  569.      Page 10                                         (printed 4/15/93)
  570.  
  571.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  572.  
  573.                     Scroll the main viewport up.
  574.  
  575.           GhostviewScrollDown()
  576.                     Scroll the main viewport down.
  577.  
  578.           GhostviewScrollLeft()
  579.                     Scroll the main viewport left.
  580.  
  581.           GhostviewScrollRight()
  582.                     Scroll the main viewport right.
  583.  
  584.           GhostviewEraseLocator()
  585.                     Used to erase the locator when leaving a Ghostview
  586.                     widget.
  587.  
  588.           GhostviewCheckFile()
  589.                     Checks to see if the file changed and refreshes
  590.                     the screen if necessary.
  591.  
  592.      APPLICATION RESOURCES
  593.           The following application resources may be set to control
  594.           the default behavior of ghostview.
  595.  
  596.           showTitle (class Labels)
  597.                     Tells whether to display the %%Title comment.  The
  598.                     default is ``true''.
  599.  
  600.           showDate (class Labels)
  601.                     Tells whether to display the %%Data comment.  The
  602.                     default is ``true''.
  603.  
  604.           showLocator (class Labels)
  605.                     Tells whether to display the locator.  The default
  606.                     is ``true''.
  607.  
  608.           installStdCmap (class InstallStdCmap)
  609.                     Tells whether to attempt to install a standard
  610.                     colormap.  The default is ``false''.
  611.  
  612.           privateCmap (class PrivateCmap)
  613.                     Tells whether to use a standard colormap that is
  614.                     not the default colormap.  The default is
  615.                     ``false''.
  616.  
  617.           autoCenter (class AutoCenter)
  618.                     Tells whether to center the page within the
  619.                     viewport whenever the page size changes.  The
  620.                     default is ``true''.
  621.  
  622.           horizonalMargin (class Margin)
  623.                     Tells how many pixels ghostview should reserve for
  624.                     window decorations in the horizontal direction.
  625.  
  626.      Page 11                                         (printed 4/15/93)
  627.  
  628.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  629.  
  630.                     The default value is ``20''.
  631.  
  632.           verticalMargin (class Margin)
  633.                     Tells how many pixels ghostview should reserve for
  634.                     window decorations in the vertical direction.  The
  635.                     default value is ``44''.
  636.  
  637.           minimumMagstep (class Magstep)
  638.                     Tells the smallest magstep to display.  The
  639.                     default is ``-5''.
  640.  
  641.           maximumMagstep (class Magstep)
  642.                     Tells the largest magstep to display.  The default
  643.                     is ``5''.
  644.  
  645.           magstep (class Magstep)
  646.                     Sets the default magstep.  The default is ``0''.
  647.  
  648.           orientation (class Orientation)
  649.                     Sets the default orientation.  The default is
  650.                     ``Portrait''.
  651.  
  652.           page (class Page)
  653.                     Gives the initial page to display.  This resource
  654.                     only affects the display of the file listed on the
  655.                     command line.  The default is NULL.
  656.  
  657.           pageMedia (class PageMedia)
  658.                     Sets the default page media.  The default is
  659.                     ``Letter''.
  660.  
  661.           forceOrientation (class Force)
  662.                     Tells whether to force the orientation on the
  663.                     document.  The default is ``false''.
  664.  
  665.           forcePageMedia (class Force)
  666.                     Tells whether to force the page media on the
  667.                     document.  The default is ``false''.
  668.  
  669.           swapLandscape (class SwapLandscape)
  670.                     Tells whether to swap the meaning of Landscape and
  671.                     Seascape.  The default is ``false''.
  672.  
  673.           printCommand (class PrintCommand)
  674.                     Sets the command used for printing.  The printer
  675.                     environment variable is set to the desired printer
  676.                     and then this command is executed using popen.
  677.                     This command should read from ``stdin'' and send
  678.                     the file to the appropriate printer.  The default
  679.                     value is ``lpr'' for BSD and ``lp'' for System V.
  680.  
  681.           printerVariable (class PrinterVariable)
  682.  
  683.      Page 12                                         (printed 4/15/93)
  684.  
  685.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  686.  
  687.                     Gives the name of the printer environment
  688.                     variable.  The default value is ``PRINTER'' for
  689.                     BSD and ``LPDEST'' for System V.
  690.  
  691.           defaultPrinter (class DefaultPrinter)
  692.                     Gives the printer name to use when the printer
  693.                     environment variable is not set.  The default
  694.                     value is NULL.
  695.  
  696.           printPrompt (class PrintPrompt)
  697.                     Sets the prompt used to ask for the printer name.
  698.                     The default value is ``Printer Name: ''.
  699.  
  700.           printFail (class printFail)
  701.                     Sets the string used to inform the user that the
  702.                     printer command failed.  The default is
  703.                     ``"lpr" command failed.''.
  704.  
  705.           openPrompt (class OpenPrompt)
  706.                     Sets the prompt used to ask for a file name to
  707.                     open.  The default value is ``Open File: ''.
  708.  
  709.           openFail (class OpenFail)
  710.                     Sets the string used to inform the user that the
  711.                     open failed.  The default value is
  712.                     ``Cannot open file: ''.
  713.  
  714.           savePrompt (class SavePrompt)
  715.                     Sets the prompt used to ask for a file name to
  716.                     save.  The default value is ``Save File: ''.
  717.  
  718.           saveFail (class SaveFail)
  719.                     Sets the string used to inform the user that the
  720.                     save failed.  The default value is
  721.                     ``Cannot save file: ''.
  722.  
  723.           openWindows (class OpenWindows)
  724.                     OpenWindows servers sometimes cause error messages
  725.                     about bitmaps not being 1 bit deep.  Turning on
  726.                     this resource avoids the problem by not using any
  727.                     bitmaps.  You lose the functionality of having the
  728.                     current magstep, orientation and media marked on
  729.                     the popup menus.  The default value is ``false''.
  730.  
  731.           ncdwm (class Ncdwm)
  732.                     The Xt Intrinsics has a bug that causes bogus
  733.                     information in the window manager size hints.
  734.                     Ncdwm and possibly other window managers get
  735.                     confused by the bogus information and make the
  736.                     window extremely small.  Twm and mwm ignore the
  737.                     bogus information.  Turning on the resource avoids
  738.                     the problem with ncdwm by doing things slightly
  739.  
  740.      Page 13                                         (printed 4/15/93)
  741.  
  742.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  743.  
  744.                     differently.  However, this can confuse other
  745.                     window managers such as mwm.  This bug is fixed in
  746.                     X11R5 fix-10.  You should only set this resource
  747.                     if you have the problem.  The default value is
  748.                     ``false''.
  749.  
  750.      GHOSTVIEW WIDGET RESOURCES
  751.           Certain resources in the Ghostview widget may be set by the
  752.           user.  These selected resources are presented below.
  753.  
  754.           busyCursor (class Cursor)
  755.                     The cursor shown when ghostscript is rendering to
  756.                     the window.  The busy cursor is set to the
  757.                     ``target'' by the application defaults.
  758.  
  759.           cursor (class Cursor)
  760.                     The cursor shown when ghostscript is idle.  The
  761.                     default cursor is the ``crosshair''.
  762.  
  763.           interpreter (class Interpreter)
  764.                     The name of the executable to call to render the
  765.                     PostScript.  It is convenient to set this resource
  766.                     to the path of an alternate version of ghostscript
  767.                     for testing.  The default value is ``gs''.
  768.  
  769.           preload (class Preload)
  770.                     Files to load before the PostScript program.  It
  771.                     is convenient to name files that preload fonts
  772.                     here for PostScript programs that continually
  773.                     reload fonts while rendering a page.  The default
  774.                     is to not preload any files.
  775.  
  776.           quiet (class Quiet)
  777.                     Tells ghostscript whether to produce informational
  778.                     messages.  The default value is ``false''.
  779.  
  780.           useBackingPixmap (class UseBackingPixmap)
  781.                     Tells whether to use a backing pixmap.  If this
  782.                     resource is false, backing store is requested on
  783.                     the Ghostview window.  Some X servers have limited
  784.                     resources for large pixmaps.  Also, some X
  785.                     servers' backing store is much faster than using a
  786.                     backing pixmap.  You should reset this resource if
  787.                     your X server is one of the server types
  788.                     mentioned.  The default value is ``true''.
  789.  
  790.           xdpi (class Resolution)
  791.                     Sets the X resolution of the window in dots per
  792.                     inch.  You can use this resource to affect the
  793.                     main window.  Zoom windows have their X dpi set
  794.                     explicitly in the program.  The default value is
  795.                     calculated from the screen metrics.
  796.  
  797.      Page 14                                         (printed 4/15/93)
  798.  
  799.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  800.  
  801.           ydpi (class Resolution)
  802.                     Sets the Y resolution of the window in dots per
  803.                     inch.  You can use this resource to affect the
  804.                     main window.  Zoom windows have their Y dpi set
  805.                     explicitly in the program.  The default value is
  806.                     calculated from the screen metrics.
  807.  
  808.      GHOSTVIEW WIDGET ACTIONS
  809.           notify(width height xdpi ydpi)
  810.                     The notify event is used by the ghostview
  811.                     application for the locator and popup zoom
  812.                     windows.  If the width and height are 0, the event
  813.                     is user for the locator.  Otherwise, it triggers a
  814.                     popup zoom window.  The default widht and height
  815.                     are 72.  The default xdpi and ydpi are 300.  The
  816.                     height will default to the width if the height is
  817.                     omitted.  The xdpi will default to the xdpi if the
  818.                     ydpi is omitted.
  819.  
  820.      OPTIONS
  821.           -staticgray
  822.                     Equivalent to setting ``*Visual: StaticGray''.
  823.  
  824.           -grayscale
  825.                     Equivalent to setting ``*Visual: GrayScale''.
  826.  
  827.           -staticcolor
  828.                     Equivalent to setting ``*Visual: StaticColor''.
  829.  
  830.           -pseudocolor
  831.                     Equivalent to setting ``*Visual: PseudoColor''.
  832.  
  833.           -truecolor
  834.                     Equivalent to setting ``*Visual: TrueColor''.
  835.  
  836.           -directcolor
  837.                     Equivalent to setting ``*Visual: DirectColor''.
  838.  
  839.           -install  Equivalent to setting ``Ghostview.installStdCmap:
  840.                     True''.
  841.  
  842.           -noinstall
  843.                     Equivalent to setting ``Ghostview.installStdCmap:
  844.                     False''.
  845.  
  846.           -private  Equivalent to setting ``Ghostview.privateCmap:
  847.                     True''.
  848.  
  849.           -noprivate
  850.                     Equivalent to setting ``Ghostview.privateCmap:
  851.                     False''.
  852.  
  853.      Page 15                                         (printed 4/15/93)
  854.  
  855.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  856.  
  857.           -center   Equivalent to setting ``Ghostview.autoCenter:
  858.                     True''.
  859.  
  860.           -nocenter Equivalent to setting ``Ghostview.autoCenter:
  861.                     False''.
  862.  
  863.           -title    Equivalent to setting ``Ghostview.showTitle:
  864.                     True''.
  865.  
  866.           -notitle  Equivalent to setting ``Ghostview.showTitle:
  867.                     False''.
  868.  
  869.           -date     Equivalent to setting ``Ghostview.showDate:
  870.                     True''.
  871.  
  872.           -nodate   Equivalent to setting ``Ghostview.showDate:
  873.                     False''.
  874.  
  875.           -locator  Equivalent to setting ``Ghostview.showLocator:
  876.                     True''.
  877.  
  878.           -nolocator
  879.                     Equivalent to setting ``Ghostview.showLocator:
  880.                     False''.
  881.  
  882.           -labels   Equivalent to setting ``Ghostview.Labels: True''.
  883.  
  884.           -nolabels Equivalent to setting ``Ghostview.Labels: False''.
  885.  
  886.           -quiet    Equivalent to setting ``*Ghostview.quiet: True''.
  887.  
  888.           -noquiet  Equivalent to setting ``*Ghostview.quiet: False''.
  889.  
  890.           -preload file
  891.                     Equivalent to setting ``*Ghostview.preload:
  892.                     file''.
  893.  
  894.           -xdpi dpi Equivalent to setting ``*Ghostview.xdpi: dpi''.
  895.  
  896.           -ydpi dpi Equivalent to setting ``*Ghostview.ydpi: dpi''.
  897.  
  898.           -resolution dpi
  899.                     Equivalent to setting ``*Ghostview.Resolution:
  900.                     dpi''.
  901.  
  902.           -dpi dpi  Equivalent to setting ``*Ghostview.Resolution:
  903.                     dpi''.
  904.  
  905.           -magstep magstep
  906.                     Equivalent to setting ``Ghostview.magstep:
  907.                     magstep''.
  908.  
  909.      Page 16                                         (printed 4/15/93)
  910.  
  911.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  912.  
  913.           -portrait Equivalent to setting ``Ghostview.orientation:
  914.                     Portrait''.
  915.  
  916.           -landscape
  917.                     Equivalent to setting ``Ghostview.orientation:
  918.                     Landscape''.
  919.  
  920.           -upsidedown
  921.                     Equivalent to setting ``Ghostview.orientation:
  922.                     Upside-down''.
  923.  
  924.           -seascape Equivalent to setting ``Ghostview.orientation:
  925.                     Seascape''.
  926.  
  927.           -forceorientation
  928.                     Equivalent to setting
  929.                     ``Ghostview.forceOrientation: True''.
  930.  
  931.           -page label
  932.                     Equivalent to setting ``Ghostview.page: label''.
  933.  
  934.           -letter   Equivalent to setting ``Ghostview.pageMedia:
  935.                     Letter''.
  936.  
  937.           -tabloid  Equivalent to setting ``Ghostview.pageMedia:
  938.                     Tabloid''.
  939.  
  940.           -ledger   Equivalent to setting ``Ghostview.pageMedia:
  941.                     Ledger''.
  942.  
  943.           -legal    Equivalent to setting ``Ghostview.pageMedia:
  944.                     Legal''.
  945.  
  946.           -statement
  947.                     Equivalent to setting ``Ghostview.pageMedia:
  948.                     Statement''.
  949.  
  950.           -executive
  951.                     Equivalent to setting ``Ghostview.pageMedia:
  952.                     Executive''.
  953.  
  954.           -a3       Equivalent to setting ``Ghostview.pageMedia: A3''.
  955.  
  956.           -a4       Equivalent to setting ``Ghostview.pageMedia: A4''.
  957.  
  958.           -a5       Equivalent to setting ``Ghostview.pageMedia: A5''.
  959.  
  960.           -b4       Equivalent to setting ``Ghostview.pageMedia: B4''.
  961.  
  962.           -b5       Equivalent to setting ``Ghostview.pageMedia: B5''.
  963.  
  964.           -folio    Equivalent to setting ``Ghostview.pageMedia:
  965.  
  966.      Page 17                                         (printed 4/15/93)
  967.  
  968.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  969.  
  970.                     Folio''.
  971.  
  972.           -quarto   Equivalent to setting ``Ghostview.pageMedia:
  973.                     Quarto''.
  974.  
  975.           -10x14    Equivalent to setting ``Ghostview.pageMedia:
  976.                     10x14''.
  977.  
  978.           -forcemedia
  979.                     Equivalent to setting ``Ghostview.forcePageMedia:
  980.                     True''.
  981.  
  982.           -force    Equivalent to setting ``Ghostview.Force: True''.
  983.  
  984.           -swap     Equivalent to setting ``Ghostview.swapLandscape:
  985.                     True''.
  986.  
  987.           -noswap   Equivalent to setting ``Ghostview.swapLandscape:
  988.                     False''.
  989.  
  990.           -openwindows
  991.                     Equivalent to setting ``Ghostview.openWindows:
  992.                     True''.
  993.  
  994.           -noopenwindows
  995.                     Equivalent to setting ``Ghostview.openWindows:
  996.                     False''.
  997.  
  998.           -ncdwm    Equivalent to setting ``Ghostview.ncdwm: True''.
  999.  
  1000.           -noncdwm  Equivalent to setting ``Ghostview.ncdwm: False''.
  1001.  
  1002.      WIDGET HIERARCHY
  1003.           The hierarchy of the ghostview application:
  1004.  
  1005.           Ghostview  ghostview
  1006.                Form  form
  1007.                     MenuButton  titleButton
  1008.                          SimpleMenu  menu
  1009.                               SmeBSB  title
  1010.                     MenuButton  dateButton
  1011.                          SimpleMenu  menu
  1012.                               SmeBSB  date
  1013.                     Label  locator
  1014.                     Box  box
  1015.                          MenuButton  fileButton
  1016.                               SimpleMenu  menu
  1017.                                    SmeBSB  open
  1018.                                    SmeBSB  reopen
  1019.                                    SmeBSB  printwhole
  1020.                                    SmeBSB  printmarked
  1021.                                    SmeBSB  save
  1022.  
  1023.      Page 18                                         (printed 4/15/93)
  1024.  
  1025.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  1026.  
  1027.                                    SmeLine  line
  1028.                                    SmeBSB  copyright
  1029.                                    SmeBSB  quit
  1030.                          MenuButton  pageButton
  1031.                               SimpleMenu  menu
  1032.                                    SmeBSB  next
  1033.                                    SmeBSB  show
  1034.                                    SmeBSB  prev
  1035.                                    SmeLine  line
  1036.                                    SmeBSB  center
  1037.                                    SmeLine  line
  1038.                                    SmeBSB  mark
  1039.                                    SmeBSB  unmark
  1040.                          MenuButton  magstepButton
  1041.                               SimpleMenu  menu
  1042.                                    SmeBSB  -5
  1043.                                    SmeBSB  -4
  1044.                                    SmeBSB  -3
  1045.                                    SmeBSB  -2
  1046.                                    SmeBSB  -1
  1047.                                    SmeBSB  0
  1048.                                    SmeBSB  1
  1049.                                    SmeBSB  2
  1050.                                    SmeBSB  3
  1051.                                    SmeBSB  4
  1052.                                    SmeBSB  5
  1053.                          MenuButton  orientationButton
  1054.                               SimpleMenu  menu
  1055.                                    SmeBSB  portrait
  1056.                                    SmeBSB  landscape
  1057.                                    SmeBSB  upsidedown
  1058.                                    SmeBSB  seascape
  1059.                                    SmeLine  line
  1060.                                    SmeBSB  swap
  1061.                          MenuButton  pagemediaButton
  1062.                               SimpleMenu  menu
  1063.                                    SmeBSB  Letter
  1064.                                    SmeBSB  Tabloid
  1065.                                    SmeBSB  Ledger
  1066.                                    SmeBSB  Legal
  1067.                                    SmeBSB  Statement
  1068.                                    SmeBSB  Executive
  1069.                                    SmeBSB  A3
  1070.                                    SmeBSB  A4
  1071.                                    SmeBSB  A5
  1072.                                    SmeBSB  B4
  1073.                                    SmeBSB  B5
  1074.                                    SmeBSB  Folio
  1075.                                    SmeBSB  Quarto
  1076.                                    SmeBSB  10x14
  1077.                     Text  toc
  1078.                     Viewport  pageview
  1079.  
  1080.      Page 19                                         (printed 4/15/93)
  1081.  
  1082.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  1083.  
  1084.                          Core  clip
  1085.                          Ghostview  page
  1086.                          Scrollbar  horizontal
  1087.                          Scrollbar  vertical
  1088.                TopLevelShell  information
  1089.                     Form  form
  1090.                          Text  text
  1091.                          Command  dismiss
  1092.                TopLevelShell  copyright
  1093.                     Form  form
  1094.                          Text  text
  1095.                          Command  dismiss
  1096.                TransientShell  popup
  1097.                     Form  dialog
  1098.                          Label  prompt
  1099.                          Text  response
  1100.                          Command  okay
  1101.                          Command  cancel
  1102.                TopLevelShell  zoom
  1103.                     Form  form
  1104.                          Ghostview  page
  1105.                          Command  dismiss
  1106.  
  1107.           The hierarchy of the Select File dialog box:
  1108.  
  1109.           TransientShell  selFile
  1110.                Form  selFileForm
  1111.                     Label  selFilePrompt
  1112.                     Text  selFileField
  1113.                     Scrollbar  selFileHScroll
  1114.                     Composite  selFileList1
  1115.                          Scrollbar  selFileVScroll
  1116.                          Scrollbar  selFileHScroll
  1117.                     Composite  selFileList2
  1118.                          Scrollbar  selFileVScroll
  1119.                          Scrollbar  selFileHScroll
  1120.                     Composite  selFileList3
  1121.                          Scrollbar  selFileVScroll
  1122.                          Scrollbar  selFileHScroll
  1123.                     Command  selFileOK
  1124.                     Command  selFileCancel
  1125.  
  1126.      ENVIRONMENT
  1127.           LPDEST    The LPDEST environment variable gives the default
  1128.                     printer destination on System V.
  1129.  
  1130.           PRINTER   The PRINTER environment variable gives the default
  1131.                     printer destination on BSD.
  1132.  
  1133.      LIMITATIONS
  1134.           If the document does not begin with ``%!PS-Adobe-'', it does
  1135.           not claim conformance to the document structuring
  1136.  
  1137.      Page 20                                         (printed 4/15/93)
  1138.  
  1139.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  1140.  
  1141.           convention.  When these documents are encountered, the
  1142.           functionality of ghostview is limited to giving you scroll
  1143.           bars and a next page capability.  Because there is no table
  1144.           of contents, skipping around the document and marking pages
  1145.           is impossible.
  1146.  
  1147.           If there is no table of contents for the document, the popup
  1148.           zoom window will always show the first page.
  1149.  
  1150.      BUGS
  1151.           If you find a bug, please send a bug report to
  1152.           ghostview@cs.wisc.edu.
  1153.  
  1154.      AUTHOR
  1155.           Copyright (C) 1992  Timothy O. Theisen
  1156.  
  1157.           This program is free software; you can redistribute it
  1158.           and/or modify it under the terms of the GNU General Public
  1159.           License as published by the Free Software Foundation; either
  1160.           version 2 of the License, or (at your option) any later
  1161.           version.
  1162.  
  1163.           This program is distributed in the hope that it will be
  1164.           useful, but WITHOUT ANY WARRANTY; without even the implied
  1165.           warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  1166.           PURPOSE.  See the GNU General Public License for more
  1167.           details.
  1168.  
  1169.           You should have received a copy of the GNU General Public
  1170.           License along with this program; if not, write to the Free
  1171.           Software Foundation, Inc., 675 Mass Ave, Cambridge, MA
  1172.           02139, USA.
  1173.  
  1174.           Author:   Tim Theisen         Systems Programmer
  1175.           Internet: tim@cs.wisc.edu     Department of Computer Sciences
  1176.           UUCP:     uwvax!tim           University of Wisconsin-Madison
  1177.           Phone:    (608)262-0438       1210 West Dayton Street
  1178.           FAX:      (608)262-9777       Madison, WI   53706
  1179.  
  1180.      ACKNOWLEDGEMENTS
  1181.           The Select File widget contains the following copyright
  1182.           notice:
  1183.  
  1184.           Copyright 1989 Software Research Associates, Inc., Tokyo,
  1185.           Japan
  1186.  
  1187.           Permission to use, copy, modify, and distribute this
  1188.           software and its documentation for any purpose and without
  1189.           fee is hereby granted, provided that the above copyright
  1190.           notice appear in all copies and that both that copyright
  1191.           notice and this permission notice appear in supporting
  1192.           documentation, and that the name of Software Research
  1193.  
  1194.      Page 21                                         (printed 4/15/93)
  1195.  
  1196.      GHOSTVIEW(1)              UNIX System V              GHOSTVIEW(1)
  1197.  
  1198.           Associates not be used in advertising or publicity
  1199.           pertaining to distribution of the software without specific,
  1200.           written prior permission.  Software Research Associates
  1201.           makes no representations about the suitability of this
  1202.           software for any purpose.  It is provided "as is" without
  1203.           express or implied warranty.
  1204.  
  1205.           SOFTWARE RESEARCH ASSOCIATES DISCLAIMS ALL WARRANTIES WITH
  1206.           REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF
  1207.           MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL SOFTWARE
  1208.           RESEARCH ASSOCIATES BE LIABLE FOR ANY SPECIAL, INDIRECT OR
  1209.           CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
  1210.           FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
  1211.           CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
  1212.           OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
  1213.           SOFTWARE.
  1214.  
  1215.           Author:   Erik M. van der Poel
  1216.                     Software Research Associates, Inc., Tokyo, Japan
  1217.                     erik@sra.co.jp
  1218.  
  1219.      Page 22                                         (printed 4/15/93)
  1220.